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EXECUTIVE  SUMMARY 


OBJECTIVE 

The  objective  of  this  research  was  to  develop  a  windowing  framework  for  accessing 
the  diverse  collections  of  software  tools  used  by  software  development  projects.  A 
major  research  goal  was  to  develop  an  environment/tool  integrator  (ETI)  that  can  easily 
be  customized  to  satisfy  the  unique  needs  of  specific  projects. 

RESULTS 

A  prototype  version  of  the  ETI  was  successfully  developed  and  demonstrated.  The 
ETI  is  being  used  by  the  Operations  Support  System  (OSS)  project  at  NRaD.  Potential 
customers  in  private  industry  were  identified  as  a  result  of  demonstrations  at  the  two 
1992  national  Armed  Forces  Communications  and  Electronics  Association  (AFCEA) 
conferences.  The  ETI  is  being  submitted  to  the  Software  Technology  for  Adaptable 
Reliable  Systems  (STARS)  Asset  Source  for  Software  Engineering  Technology  (ASSET) 
library. 

RECOMMENDATIONS 

1.  More  help  from  human  factors  experts  is  needed  during  the  development  of  user 
interfaces  for  DoD  software  and  computer-aided  software  engineering  (CASE) 
tools.  The  operation  of  these  user  interfaces  can  and  must  be  simplified. 

2.  Ada  repositories  should  be  cleaned  up  with  help  from  users.  Tools  that  do  not 
work  or  are  of  marginal  quality  should  be  removed. 

3.  The  Ada  Joint  Program  Office,  National  Aeronautics  and  Space  Administration  or 
other  government  organizations  should  provide  support  to  AdaNet  to  improve  the 
quality  of  tools  in  the  repository.  X  front-ends,  modifications  to  increase  portabil¬ 
ity,  and  other  enhancements  would  benefit  the  entire  Ada  community. 

4.  A  number  of  enhancements  should  be  made  to  the  ETI.  The  customer  base  should 
be  broadened  by  porting  it  to  additional  Unix-based  platforms.  A  context-sensitive 
help  feature  and  tool  search  capability  should  be  provided.  Additional  Ada,  C,  and 
C++  public  domain  tools  are  needed.  X/Motif  front-ends  for  these  tools  should  be 
developed  to  facilitate  their  use. 


m 


CONTENTS 


EXECUTIVE  SUMMARY . iii 

ACRONYMS  AND  ABBREVIATIONS  . vii 

1.0  INTRODUCTION . 1 

2.0  BACKGROUND . 2 

3.0  CHARACTERISTICS  . 3 

3.1  KEY  FEATURES . 3 

3.2  REQUIRED  HARDWARE  AND  SOFTWARE . 3 

4.0  USING  THE  ENVIRONMENT/TOOL  INTEGRATOR . 4 

4.1  INSTALLATION  . 4 

4.1.1  Installation  from  NRaD  Tape  . 4 

4.1.2  Installation  from  STARS  ASSET  Library . 5 

4.2  EXECUTION . 6 

4.2.1  Invoking  the  Environment/Tool  Integrator . 6 

4.2.2  Top-Level  Window  Description . 6 

4.2.3  Tool  Invocation . 7 

4.3  TAILORING . 8 

4.3.1  Version  1.1  As  Delivered  . 8 

4.3.2  An  Example  of  Tailoring  to  a  Specific  Project . 11 

5.0  LESSONS  LEARNED . 13 

5.1  VALUE  OF  DEMONSTRATIONS . 13 

5.2  ADVANTAGE  OF  FINDING  USERS  EARLY . 13 

5.3  ADA  VERSUS  C  FOR  DEVELOPMENT . 13 

5.4  OPEN  LOOK  VERSUS  MOTIF . 14 

5.5  TAILORING . 14 

5.6  SOURCES  FOR  PUBLIC  DOMAIN  TOOLS  . 14 

5.7  HUMAN  FACTORS  INVOLVEMENT  . 15 

6.0  RECOMMENDATIONS  . 16 

6.1  RECOMMENDATIONS  FOR  FUTURE  EH  RESEARCH . 16 

6.2  RECOMMENDATIONS  FOR  SOFTWARE  DEVELOPERS  . 16 


v 


7.0  REFERENCES . 17 

8.0  BIBLIOGRAPHY  . 18 

APPENDICES: 

A.  USING  THE  TOOLS  . A-l 

A.l  C  TOOLSET  . A-l 

A.2  ADA  TOOLSET  . A-4 

A.3  UTTLiTY . A-6 

B.  BACKGROUND  INFORMATION  ON  THE  ADA  TOOLS . B-l 

FIGURES 

1.  Top-level  window  . 6 

2.  Top-level  window  with  tools  and  options  displayed  . 7 

3.  Top-level  window  with  subcategory  of  editors  displayed  . 8 

4.  Example  of  setup  table  . 9 

5.  Top-level  window  with  tools  and  options  displayed  tailored  to  a 

specific  project  . 12 

6.  Example  of  setup  table  tailored  to  a  specific  project . 12 

A-l.  Menu  for  C  line  counter  . A-2 

A-2.  Menu  for  C  pretty  printer  . A-3 


vi 


ABOM 


ACRONYMS  AND  ABBREVIATIONS 

Ada  Bit-Oriented  Message  Handler  project 
ALS/N  -  Ada  Language  System/Navy 

AFCEA  -  Armed  Forces  Communications  and  Electronics  Association 
APRICOT  -  Ada  Primitive  Compilation  Order  Tool 

ASR  -  Ada  Software  Repository 

ASSET  -  Asset  Source  for  Software  Engineering  Technology 

CARDS  -  Central  Archive  for  Reusable  Defense  Software 

CASE  -  computer-aided  software  engineering 

CIM  -  corporate  information  management 

CRSS  -  C3I  Reusable  Software  System 

C3  -  command  control  and  communications 

DoD  -  Department  of  Defense 

DTC-2  -  desk-top  computer-2 

EH  -  Environment/Tool  Integrator 

GUI  -  graphical  user  interface 

IDE  -  Interactive  Development  Environments 

LAN  -  local  area  network 

MACA  -  Management  Assistance  Corporation  of  America 

MIT  -  Massachusetts  Institute  of  Technology 

NASA  -  National  Aeronautics  and  Space  Administration 

NED  -  Navy  Command  and  Control  System  Ashore  Editor 

NRaD  -  Naval  Command,  Control  and  Ocean  Surveillance  Center, 

Research,  Development,  Test  and  Evaluation  Division 

OSS  -  Operations  Support  System 

SAIC  -  Science  Applications  International  Corporation 


SAINT 


Shared  Adaptive  Internetworking  project 
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SWEEP  -  Software  Engineering  Environment  Prototypes 

TAC-3  -  Tactical  Advanced  Computer  3 
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1.0  INTRODUCTION 


This  report  describes  the  environment/tool  integrator  (Ell)  that  was  developed 
under  the  Software  Engineering  Environment  Prototypes  (SWEEP)  task  of  the  Software 
Engineering  for  Command  Control  and  Communications  (C3)  Systems  project.  The 
ETI  is  a  windowing  framework  for  accessing  software  tools.  It  can  be  easily  custom¬ 
ized  to  satisfy  the  needs  of  a  project.  The  EU  allows  users  to  define  (1)  the  tool  cate¬ 
gories  that  are  appropriate  for  a  specific  project  and  (2)  the  interfaces  for  accessing 
individual  tools.  Tools  that  may  be  accessed  include  computer-aided  software  engineer¬ 
ing  (CASE)  tools,  software  engineering  environments,  reuse  libraries,  project-specific 
tools,  public  domain  tools,  and  utility  tools  (such  as  mailer  and  calculator). 

The  ET1  provides  a  convenient  way  of  displaying  all  tools  that  are  available  to  a 
project  development  team.  It  supports  multiple  programming  languages  as  well  as  dif¬ 
ferent  applications  (e.g.,  C3  tactical  applications  and  corporate  information  manage¬ 
ment  (CM)  applications). 

The  ETI  and  all  tools  that  are  invoked  from  it  must  execute  on  Unix  (SunOS 
4.1.1).  Tools  may  reside  on  various  workstations  in  a  local  area  network  (LAN). 

The  ETT,  version  1.1,  is  being  submitted  to  the  Software  Technology  for  Adaptable 
Reliable  Systems  (STARS)  Asset  Source  for  Software  Engineering  Technology  (ASSET) 
library,  where  it  will  be  available  to  STARS  affiliates  at  no  cost.  A  number  of  Ada 
and  C  public  domain  tools  are  included,  such  as  an  Ada  pretty  printer,  an  Ada  line 
counter,  an  Ada  body  stubber,  a  C  pretty  printer,  a  C  line  counter,  and  an  editor. 

The  ETI  was  developed  in-house  by  the  Naval  Command,  Control  and  Ocean  Sur¬ 
veillance  Center,  Research,  Development,  Test  and  Evaluation  Division  (NRaD).  It  is 
currently  being  used  by  the  Operations  Support  System  (OSS)  project  at  NRaD. 

This  report  includes  the  following  information  on  Version  1.1  of  the  ETI: 

•  Background 

•  Characteristics 

•  User  instructions 

•  Lessons  learned 

•  Recommendations 

•  Description  of  the  tools  included 

Potential  users  of  the  ETI  and  this  report  are  software  developers  who  use  Unix- 
based  computers. 


1 


2.0  BACKGROUND 


The  need  for  the  ETI  was  recognized  by  observing  the  way  in  which  software  was 
being  developed  for  several  projects  at  NRaD  and  at  other  Navy  laboratories.  Prob¬ 
lems  recognized  that  can  be  solved  or  minimized  by  using  the  EH  include  the  four 
summarized  below. 

1.  Project  software  engineers  are  sometimes  unaware  of  potentially  useful  tools 
available  for  software  development,  even  when  they  reside  on  project  computers. 
Very  useful  tools  that  can  be  used  are  not  being  applied. 

2.  Most  commercially  available  environments  have  extensibility  limitations.  Exam¬ 
ples  of  limitations  include  the  following: 

•  Users  cannot  add  their  own  tools  because  the  environment  is  predetermined 
and  cannot  be  modified  by  the  user. 

•  Tool  integration  is  possible  but  difficult  and  time  consuming. 

•  Tool  integration  is  possible  but  can  only  be  done  in  such  a  way  that  the 
newly  integrated  tool  is  accessed  by  traversing  through  layers  of  menus. 

•  Upon  the  release  of  a  new  version  of  an  environment,  users  must  reintegrate 
project  tools. 

3.  Commercial  environments  are  frequently  tied  to  one  computer  language  or  one 
compiler  (theirs).  NRaD  and  Navy  projects  often  use  multiple  programming  lan¬ 
guages. 

4.  Licensing  and  cost  considerations  preclude  the  widespread  use  of  commercial 
environments. 

The  ETI  addresses  each  of  these  four  problems. 

1.  It  provides  a  way  in  which  project  users  can  view  and  access  all  available  pro¬ 
ject  tools.  This  is  especially  helpful  for  programmers  who  are  new  to  a  project. 

2.  It  provides  an  alternative  to  integrating  tools  into  commercial  environments. 
Tools  may  be  integrated  into  and  accessed  from  the  ETI.  Multiple  commercial 
environments  and  reuse  libraries  can  be  accessed  from  it. 

3.  The  ETI  is  not  tied  to  any  one  language  or  compiler.  Multiple  compilation  sys¬ 
tems  may  be  accessed. 

4.  The  EH  is  public  domain  software.  It  is  being  submitted  to  the  STARS  ASSET 
library. 
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3.0  CHARACTERISTICS 


This  section  describes  the  key  features  of  the  ETI  and  the  required  hardware  and 
software. 

3.1  KEY  FEATURES 

•  Provides  a  capability  for  using  software  tools,  environments,  and  reuse  librar¬ 
ies  in  an  integrated  manner  for  software  development. 

•  Offers  easy  customization  by  users.  Project  members  can  define  tool  catego¬ 
ries  and  tool  interfaces  by  creating  a  setup  table.  Knowledge  of  graphical 
user  interface  (GUI)  builder  tools  and  X/Motif  is  not  required. 

•  Includes  enhanced  public  domain  Ada  and  C  software  development  tools  and 
utility  tools. 

•  Provides  interfaces  to  commercial  environments  and  tools. 

•  Conforms  to  Navy  command  and  control  user  interface  specifications  (Ref. 

1). 

•  Includes  on-line  help  facility. 

•  Provides  portability  across  platforms  (Unix). 

3.2  REQUIRED  HARDWARE  AND  SOFTWARE 

•  Currently  executes  on  Sun  3,  Sun  4,  DTC-2,  and  other  computers  using 
SunOS  4.1.1. 

•  Requires  X/Motif  (X11R4  libraries  and  Motif  1.1.1). 
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4.0  USING  THE  ENVIRONMENT/TOOL  INTEGRATOR 

4.1  INSTALLATION 

Instructions  are  provided  below  for  installing  the  ETI  from  (1)  a  tape  provided  by 
NRaD  or  (2)  the  STARS  ASSET  library. 

It  is  assumed  that  the  user  is  running  the  Unix  “C-shell”  for  the  Sun  SPARC  using 
SunOS  4.1.1  and  that  he  or  she  has  a  basic  understanding  of  the  Unix  operating  sys¬ 
tem  commands.  Note,  if  running  another  shell  (e.g.,  KORN),  the  installation  proce¬ 
dures  will  be  different. 

Before  following  the  steps  below,  move  to  the  directory  where  the  ETI  is  to  be 
installed  using  the  Unix  command  "cd".  Choose  the  directory  of  your  cnoice  then 
follow  the  appropriate  set  of  instructions. 

4.1.1  Installation  from  NRaD  Tape 

1.  Unload  Files  from  Tape 

Insert  the  ETI  tape  in  the  tape  drive.  Unload  the  files  on  the  tape  using  the  com¬ 
mand  given  below.  This  will  automatically  create  the  directory  " sweep  1 . 1 

tar  xvf  /dev/rstO  ./sweepl.l 

2.  Set  Up  the  Environment  Variables 

Set  up  the  environment  variables  in  the  file  " .  cshrc" .  This  file  must  be  in  your 
home  directory.  Place  the  following  commands  at  the  bottom  of  this  file  using  an  edi¬ 
tor: 

setenv  SWEEP_HOME  <path>/sweepl . l 

set  path= ($SWEEP_HOME/bin  $path) 

setenv  XAPPLRESDIR  $SWEEP_HOME/app-defaults/ 

Exit  the  file. 

Note,  <path>  in  the  first  command,  indicates  that  you  must  specify  the  appropriate 
complete  path  name. 

Next,  type  the  following  to  set  the  environment  variables: 
source  -/.cshrc 

You  may  confirm  the  success  of  the  installation  by  invoking  the  ETI  and  noting  that 
the  top-level  window  is  displayed  on  your  screen.  The  invocation  step  and  a  picture  of 
the  top-level  window  are  given  in  Section  4.2.1. 
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4.1.2  Installation  from  STARS  ASSET  Library 


1.  Extract  and  Transfer  Files  to  Host  Computer 

a.  Get  Account  on  STARS  ASSET  Computer 

Before  installing  the  ETI  from  the  STARS  ASSET  library,  you  must  first  get  an 
account  on  the  ASSET  computer.  To  do  this,  call  304-594-1762  to  get  a  user  form. 
Fill  it  out  and  return  it  to  the  ASSET  library  system  administrator. 

b.  Retrieve  the  Environment/Tool  Integrator 

First  connect  your  host  computer  to  the  ASSET  computer  by  typing 
telnet  source.asset.com  (192.131.125.10) 
and  logging  on  using  your  userid  and  password. 

Then,  to  access  the  STARS  ASSET  repository  type 
repos 

Do  an  "Asset  Search"  and  "Search"  to  scroll  through  the  list  of  assets. 
When  the  ETI  is  highlighted,  do  an  "Extract".  This  retrieves  the  ETI  files  from  the 
library  and  copies  them  to  your  current  directory  on  the  ASSET  computer. 

If  detailed  instructions  for  using  the  ASSET  library  are  needed,  go  back  to  the 
"repos"  level  menu,  select  "User's  Manual",  and  browse  to  the  appropriate 
instructions. 

c.  Transfer  the  Environment/Tool  Integrator  Files 

Transfer  the  files  using  "ftp" ,  Kermit,  or  other  file  transfer  software  from  the 
ASSET  computer  to  your  host  computer. 

2.  Uncompress  and  Restore  File 

Enter  the  following  commands: 

uncompress  sweep. z 
tar  xvf  sweep 

The  first  command  uncompresses  the  single  ETI  file  "sweep.Z",  and  replaces  it 
with  the  file  "sweep".  The  second  creates  the  individual  files  and  automatically  cre¬ 
ates  the  directory  "  sweep  1 . 1 " . 

3.  Set  Up  the  Environment  Variables 

Follow  the  same  steps  as  given  in  Section  4.1.1.,  subparagraph  2  above. 
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4.2  EXECUTION 


4.2.1  Invoking  the  Environment/Tool  Integrator 
Execute  the  ETI  (in  any  directory)  by  typing 
sweep 

The  top-level  window  shown  in  figure  1  will  appear  on  the  user’s  monitor.  This 
window  may  be  tailored  to  fit  the  specific  needs  of  individual  projects.  Tailoring  is 
discussed  in  Section  4.3. 


STATUS  INDICATOR 


SWEEP  ENVIRONMENT/TOOL  INTEGRATOR 


UNCLASSIFIED 


DATE/TIME 


Reuse  Library  GUI  Builder  C  Toolset  ADA  Toolset  Environment  CASE  Toolset  Utility  System  Help 


Figure  1.  Top-level  window. 


4.2.2  Top-Level  Window  Description 

At  the  top  of  figure  1,  below  the  line  "SWEEP  ENVIRONMENT/TOOL  INTEGRA¬ 
TOR"  ,  is  the  "STATUS  INDICATOR"  position,  where  a  short  message  is  displayed 
if  a  problem  occurs.  Following  this  is  the  "SECURITY  CLASSIFICATION"  position 
which,  in  this  example,  is  set  to  "UNCLASSIFIED".  This  position  represents  the 
highest  level  of  classification  for  any  project  data.  The  "DATE /TIME"  position  indi¬ 
cates  the  current  date  and  time  based  on  the  system  date  and  time. 

The  next  line  shows  the  seven  tool  categories  as  well  as  the  "System"  and 
"Help"  capabilities. 

Figure  2  shows  the  individual  tools  within  each  tool  category  and  the  options  avail¬ 
able  under  "System"  and  "Help".  In  this  figure,  all  options  are  displayed.  (This 
is  done  for  explanatory  purposes  only.  In  actual  use,  tools  may  be  displayed  for  only 
one  category  at  a  time.) 

In  figure  2,  the  tools  that  are  displayed  in  bold  print  (black  on  the  monitor)  are 
included  with  Version  1.1  of  the  ETI.  Those  that  are  not  included  appear  in  italic 
print  in  the  figure  (gray  on  the  monitor).  Tools  displayed  in  gray  have  not  been 
installed.  Most  tools  displayed  in  gray  are  commercially  available  and,  if  needed  by 
the  project,  must  be  purchased.  Note  that  figure  2  shows  that  the  current  (ETI  Ver¬ 
sion  1.1)  C  Toolset  contains  a  line  counter  and  pretty  printer,  that  the  Ada  Toolset 
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contains  a  body  stubber,  line  counter,  pager,  and  pretty  printer,  and  that  the  utility 
tools  are  a  calculator,  clip  board,  command  shell,  editors,  E-mailer,  and  file  manager. 
The  right  arrow  next  to  "Editor"  indicates  that  multiple  editors  are  provided. 


)  SWEEP  ENVIRONMENT/TOOL  INTEGRATOR 

STATUS  INDICATOR 

UNCLASSIFIED 

DATE/TIME 

Reuse  Library  GUI  Builder 

C  Toolset  ADA  Toolset  CASE  Toolset  Utility  System  Help 

r—  -  — 1  1 - 1  1 - 1  1  ll - lr - 1  1 - 1 

Xcessory  Counter 

TAE+  Pretty 

TeleUse  Printer 


Body  Stubber 

Compilation 
Order  Maker 

Line  Counter 

Pager _ 

Pretty  Printer 


Sun  Ada 

Dev  Environment 

RISCAda 

Ada  Reverse 
Engineering 

VADSAPSE 


On  Window 


Clip  Board 

Command 

Shell 

Editor  ► 

EMail 

Flie 

Manager 


On  Keys 


Figure  2.  Top-level  window  with  tools  and  options  displayed. 

Next,  note  the  options  that  are  provided  under  "System"  and  ’’Help”,  on  the 
right-hand  side  of  the  window.  "System"  is  for  executing  the  ETI  system  functions. 
In  Version  1.1,  the  only  option  available  is  to  exit  the  ETI.  The  "Help"  capability 
provides  the  user  with  (1)  help  instructions  for  the  top-level  window,  (2)  help  instruc¬ 
tions  for  using  the  keyboard  function  keys,  and  (3)  EH  version  information. 

The  ETI  is  initially  configured  to  include  the  seven  tool  categories  and  the  tools 
indicated  in  figure  2.  This  configuration  may  be  changed  by  following  the  tailoring 
instructions  given  in  Section  4.3.  The  number  of  tool  categories,  names  of  the  tool 
categories,  and  tools  within  each  may  be  changed.  All  projects  probably  will  want  to 
keep  the  "Utility"  and  "Help"  categories.  "System"  is  the  only  category  that 
the  user  cannot  customize. 

Figure  3  shows  the  subcategory  capability.  The  right  arrow  pointing  from 
"Editor"  indicates  that  multiple  editors  may  be  selected.  The  editors  within  this 
subcategory  are  the  NED,  Emacs,  and  Xedit  editors.  A  brief  description  of  the  NED 
is  contained  in  Appendix  A.  A  more  complete  description  is  contained  in  Ref.  2. 

NED  complies  with  the  Navy  Command  and  Control  user  interface  specifications  (Ref. 
1).  Emacs  is  the  GNU  Emacs  editor,  which  is  in  the  public  domain.  Xedit  is  an  X 
editor,  which  is  also  in  the  public  domain. 

4.2.3  Tool  Invocation 

Individual  tools  are  invoked  in  the  standard  Motif  manner:  click  the  left  mouse  but¬ 
ton  on  the  tool  category  and  then  click  the  left  mouse  button  on  the  appropriate  tool. 

A  description  of  the  ETI  tools  is  given  in  Appendix  A. 
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SWEEP  ENVIRONMENT/TOOL  INTEGRATOR 

STATUS  INDICATOR 

UNCLASSIFIED 

DATE/TIME 

Rausa  Library  GUI  Bulldar 

C  Toolsat  ADA  Toolaat  r^rtrnnS  CASE  Toolset  Utility  Systam  Holp 

Figure  3.  Top-level  window  with  subcategory  of  editors  displayed. 


4.3  TAILORING 

Users  are  allowed  to  define  the  name  of  the  top-level  window,  the  classification  of 
project  data,  the  number  of  tool  categories,  the  names  of  the  tool  categories,  and  the 
tools  within  each  category.  However,  to  be  in  compliance  with  the  Navy  Command 
and  Control  user  interface  specifications  (Ref.  1),  the  ETI  should  not  have  more  than 
ten  categories  plus  "Help"  and  should  not  have  more  than  ten  tools  within  each  cate¬ 
gory. 

4.3.1  Version  1.1  as  Delivered 

The  window  and  tool  categories  shown  in  figure  2  are  automatically  produced  from 
the  setup  table  shown  in  figure  4.  The  setup  table,  contained  in  the  file  "  sweep_ 
conf ig"  ,  was  automatically  loaded  during  installation.  The  setup  table  is  free  for¬ 
mat  (i.e.,  there  is  at  least  one  blank  space  separating  each  field). 

4.3.1. 1  Setup  Table.  At  the  top  of  the  setup  table,  the  field  "SWEEP  ENVIRON¬ 
MENT/TOOL  INTEGRATOR"  provides  the  name  of  the  top-level  window,  which  is  dis¬ 
played  at  the  top  of  figure  2.  The  next  field  in  figure  4,  "UNCLASSIFIED",  gives 
the  highest  level  of  classification  of  the  project  data. 

Next,  note  the  tool  category  names  and  the  tool  names  on  the  left  side  of  the  table. 
Both  must  be  enclosed  in  quotes.  To  the  right  of  each  tool  name  is  the  executable 
field.  This  field  can  be  represented  in  three  different  ways: 
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“SWEEP  ENVIRONMENT/TOOL  INTEGRATOR" 

“UNCLASSIFIED" 

“Reuse  Library " : 

“CARDS" 

« 

“CRSS“ 

HU  . 

“GUI  Builder* : 

“Builder  Xcessory" 

NH 

"TAE+" 

HU 

"TeleUse" 

HM. 

“C  Toolset  * : 

“Line  Counter* 

*line_counter* , 

“Pretty  Printer* 

*pretty_printer“; 

“ADA  Toolset  “ : 

“Body  Stubber* 

“stubber.exe* 

‘Compilation  Order  Maker* 

■  H 

“Line  Counter* 

“linecounter.exe", 

'Pager* 

“pager.exe* 

‘Pretty  Printer* 

■pretty_print.exe"; 

“Development  Environment  *: 

’Sun  Ada  Dev  Environment* 

N« 

“EZ-Ada* 

MN 

“Ada  Reverse  Engineering* 

MM 

“VADS  APSE* 

■  ». 

‘CASE  Toolset  *: 

*StP* 

*stp  -geometry  +0+1 20"; 

■Utility*: 

‘Calculator* 

“xcalc  -geometry  +1 0+1 20“ 

’Clip  Board* 

"xclipboard  -geometry  +1 0+1 20“ 

“Command  Shell* 

"xterm  -geometry  +10+120  -fn  1 0x20“  , 

“Editor*. 

“Ned* 

*$SWEEP_HOME/birVned" 

“Emacs* 

"xterm -fn  10x20 -e  emacs’ 

•Xedit* 

"xedit* 

•E-mail* 

*xmh  -geometry  +10+120" 

“File  Manager* 

*file_manager*  ; 

Help: 

“On  Window* 

’help.window* , 

■On  Keys* 

“help.keys* 

’On  Version* 

’help.version* ; 

Figure  4.  Example  of  setup  table. 
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1.  It  can  be  the  path  name  with  the  executable  file  name.  This  string  must  be 
enclosed  in  quotes. 

For  example,  look  about  two  thirds  of  the  way  down  figure  4.  In  the  "Util¬ 
ity"  category,  "Editor"  subcategory,  editor  "Ned",  the  path  name  to 
the  NED  executable  is  the  path  name  including  the  executable  file,  "$SWEEP_ 
HOME/bin/ned" . 

2.  It  can  be  the  executable  file  name  enclosed  in  quotes  (without  the  path  name). 
In  this  case,  the  path  name  must  be  set  in  the  " .  cshrc"  file. 

For  example,  in  the  "C  Toolset"  category  (towards  the  top  of  figure  4),  for 
"Line  Counter"  ,  the  executable  field  is  "  1  ine_counter " ,  which  indi¬ 
cates  that  the  path  name  is  in  "  .  cshrc"  . 

3.  It  can  be  a  pair  of  contiguous  quotes.  This  indicates  that  the  executable  file 
name  has  not  been  specified.  This  may  be  used,  for  example,  to  show  that 
there  is  a  place  for  the  tool,  but  that  it  has  not  been  purchased  or  is  not  pres¬ 
ently  available. 

The  "CARDS"  and  "CRSS"  library  executable  fields  are  specified  in  this  man¬ 
ner. 

Also  note  that  subcategories  of  tools  can  be  defined.  For  example,  the  "Util¬ 
ity"  category  has  the  "Editor"  subcategory  that  consists  of  the  three  editors: 
Ned,  Emacs,  and  Xedit. 

Finally,  note  the  file  names  "help .window",  "help. keys",  and  "help, 
version" ,  on  the  bottom  right  of  the  table  under  "Help"  category.  These  files 
contain  text  for  the  on-line  help  and  must  be  placed  in  the  directory 
"  $  S  WEEP_HOME  /help". 

Keep  the  following  rules  in  mind  when  creating  a  setup  table. 

•  Each  tool  category  name  is  enclosed  in  quotes  followed  by  a  colon  (with  the 
exception  of  the  "help"  category). 

•  Each  tool  name  is  enclosed  in  quotes. 

•  The  delimiter  separating  tool  information  is  a  comma. 

•  The  end  of  the  category  information  is  indicated  with  a  semicolon. 

•  When  the  name  of  the  executable  file  is  not  given  within  quotes,  the  tool 
will  appear  in  gray  on  the  monitor. 

•  When  there  is  a  subcategory  of  tools,  the  rules  are  analogous  to  those  for  a 
category  of  tools. 
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-  The  subcategory  name  is  enclosed  in  quotes  followed  by  a  colon. 

-  Each  tool  name  is  enclosed  in  quotes. 

-  The  delimiter  separating  tool  information  is  a  comma. 

-  The  end  of  the  subcategory  is  indicated  with  a  semicolon. 

4.3.I.2.  X  Instructions.  Note  in  figure  4  that  sometimes  following  the  executable 
file  name,  there  are  additional  instructions.  These  are  command  line  X  instructions 
that  the  user  may  or  may  not  need. 

A  short  explanation  of  these  instructions  is  provided  here.  A  detailed  explanation 
is  found  in  the  on-line  user’s  manual  "man  pages"  (Ref.  3),  which  is  included  with 
the  X  Window  System  from  the  Massachusetts  Institute  of  Technology  (MIT). 

Find  the  executable  file  "stp"  about  two  thirds  of  the  way  down  figure  4,  on  the 
right.  The  expression  "-geometry  +0+120”  is  an  X  instruction  that  tells  StP  that 
the  starting  x,y  pixel  position  for  StP  is  0,120.  This  is  needed  to  insure  that  the  StP 
windows  do  not  overlay  the  ETI  top-level  window  (figure  1).  The  user  may  arbitrarily 
select  any  x  pixel  position  that  lies  on  the  screen.  The  y  pixel  position  is  critical  in 
that  it  should  be  chosen  so  that  the  tool’s  windows  are  positioned  below  the  ETI  top- 
level  window. 

Now,  further  down  in  figure  4,  find  the  "Emacs"  editor.  The  expression  "xterm 
-fn  10X20  -e  emacs”  indicates  that  (1)  the  font  size  for  the  emacs  editor  is 
10  X20  pixel  fixed-width  font  (the  emacs  font  size  was  increased  from  the  default 
size  to  increase  readability),  (2)  emacs  is  executed  inside  the  xterm  window. 


4.3.2  An  Example  of  Tailoring  to  a  Specific  Project 

Figure  5  shows  the  top-level  window  for  a  hypothetical  project  (when  all  tools  and 
options  are  displayed).  This  project  does  not  use  Ada  but  uses  C  and  FORTRAN. 

Note  how  this  top-level  window  differs  from  the  one  given  in  figure  2.  The  label  at 
the  top  of  the  screen  is  now  "PROJECT  X"  .  The  category,  "FORTRAN  Tool- 
set" ,  was  created  (fourth  category).  For  Project  X,  a  number  of  project-specific 
tools  are  used,  so  the  next  tool  category,  "Project  X  Tools" ,  was  created. 
Finally,  two  different  CASE  tools  are  used,  Code  Center  and  Cadre  Teamwork. 

•  Figure  6  shows  the  changes  that  were  made  to  the  setup  table  to  tailor  the  ETI  to  a 

specific  project.  The  changes  were  made  to  the  file  "sweep_conf  ig" .  After 
making  the  appropriate  changes,  the  user  types 

sweep 

to  bring  up  the  EH  as  shown  in  figure  5. 
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PROJECT  X 


STATUS  INDICATOR 

UNCLASSIFIED 

DATE/TIME 

Rauae  Library  GUI  Buildar 

C  Toolaat  FORTRAN  Toolsat  Pro|aci  X  Tool*  CASE  Toolaat  utility  Systam  Halp 

Figure  5.  Top-level  window  with  tools  and  options  displayed  tailored 
to  a  specific  project. 


■PROJECT  X" 

•UNCLASSIFIED" 

"Reuse  Library  • : 

(  'CARDS' 

"xterm  -e  RLF  GB‘; 

•GUI  Builder  * : 

'Builder  Xcessory" 

"bx" 

"TAE+" 

"tae" 

TeleUse" 

"teteuse"; 

•C  Toolset  • : 

"Line  Counter" 

"line_counter" . 

"Pretty  Printer" 

"pretty_pnnter"; 

■FORTRAN  Toolset": 

"Line  Counter" 

"fortranjine  counter.exe". 

"Pretty  Printer" 

"fortran _pretty _print.exe" . 

"Profiler" 

"fortran  _profiler  exe* 

‘Project  X  Tools'. 

"Test  Set  Generator" 

"testsetgen", 

"Documentation  Generator" 

"docgen" 

"CASE  TOOLSET ":  1 

"Code  Center" 

"xcodecenter". 

"Cadre  Teamwork" 

"cadre" 

■Utility ": 

"Calculator" 

"xcalc -geometry +10+120’ 

"Clip  Board" 

"xclipboard -geometry +10+120" 

"Command  Shell" 

"xterm  -geometry  +10+120  -fn  10x20" 

!  "Editor": 

"Ned" 

"ned" 

"Emacs" 

"xterm  -fn  1 0x20  -e  emacs" 

"Xedit" 

"xedit" 

"E-mail" 

"xmh -geometry +10+120" 

"File  Manager" 

*file_manager" 

Help. 

"On  Window" 

"help  window" , 

"On  Keys" 

"hotkeys" 

"On  Version" 

"help.version' ; 

Figure  6.  Example  of  Setup  Table  Tailored  to  a  specific  project. 
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5.0  LESSONS  LEARNED 


This  section  describes  the  lessons  that  were  learned  in  a  number  of  areas  during 
the  development  of  the  ETI.  Lessons  learned  include  the  use  of  Ada  versus  C,  the 
choice  of  the  GUI  specification,  tailoring  approaches,  and  sources  for  public  domain 
tools. 

Lessons  have  been  learned  in  a  number  of  areas  during  the  development  of  the 
ETI. 

5.1  VALUE  OF  DEMONSTRATIONS 

Task  members  were  successful  in  finding  a  transition  project  and  users  for  the  ETI 
by  rapidly  developing  a  functional  prototype  which  was  demonstrated  repeatedly.  Task 
members  felt  that  the  initial  prototype  offered  enough  functionality  that  project  devel¬ 
opers  would  recognize  its  potential.  Demonstrations  were  given  to  key  personnel  of 
candidate  projects  at  NRaD  and  other  Navy  laboratories.  Private  industry  users  were 
found  by  giving  demonstrations  at  national  AFCEA  conferences. 

Demonstrations  led  to  ETI  improvements  as  a  result  of  user  feedback.  Examples 
of  helpful  suggestions  include  (1)  making  the  entire  top-level  window  tailorable,  (2) 
adding  a  tool  search  capability  for  finding  the  category  where  a  tool  is  located,  and  (3) 
including  a  context-sensitive  help  capability.  The  final  capability  allows  a  user  to  get 
help  on  a  particular  field  by  positioning  the  cursor  on  the  field  and  then  clicking  the 
mouse  button. 


5.2  ADVANTAGE  OF  FINDING  USERS  EARLY 

Early  in  the  development  of  the  ETI  the  NRaD  OSS  project  members  made  many 
valuable  suggestions  including  providing  the  capability  for  subcategories  of  tools  and 
reducing  the  size  of  the  top-level  window  so  that  other  application  windows  were  vis¬ 
ible. 

5.3  ADA  VERSUS  C  FOR  DEVELOPMENT 

The  ETI  was  developed  using  the  C  GUI  builder,  Builder  Xcessory.  When  the  ETI 
*  development  started,  the  only  Ada  GUI  builder  available  was  TAE+,  and  it  lacked 

maturity. 

If  we  were  to  start  development  today,  we  would  probably  do  it  in  Ada.  TAE+  has 
improved,  and  a  number  of  other  Ada  compatible  GUI  builders  have  appeared  in  the 
market  place. 
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5.4  OPEN  LOOK  VERSUS  MOTIF 


The  first  prototype  of  the  ETI,  which  was  written  using  Open  Look,  was  demon¬ 
strated  to  managers  and  technical  representatives  of  NRaD  projects.  Acceptance  was 
low  because  these  projects  had  chosen  Motif  as  the  user  interface  standard.  Once  we 
changed  to  Motif,  customer  enthusiasm  increased  significantly. 

5.5  TAILORING 

Three  tailoring  approaches  were  considered.  The  first  approach  was  to  have  the  4. 

user  employ  a  GUI  builder  to  customize  the  ETI  to  meet  his  or  her  needs.  The  second 
was  to  provide  an  automated  method  for  constructing  the  windowing  framework  from  a 
setup  table.  The  third  was  to  extend  the  second  approach  by  building  the  setup  table 
from  an  interactive  program.  The  second  approach  was  followed.  The  first  approach 
was  not  chosen  because  it  requires  the  user  to  know  Motif  and  how  to  use  a  GUI 
builder.  The  third  was  not  done  with  the  ETI,  version  1.1,  because  of  time  constraints 
and  because  it  would  probably  not  be  significantly  easier  for  the  user. 

5.6  SOURCES  FOR  PUBLIC  DOMAIN  TOOLS 

The  source  of  most  Ada  public  domain  tools  was  the  Ada  Software  Repository 
(ASR)  at  White  Sands,  New  Mexico,  and  the  AdaNet  repository  in  Dellslow,  West  Vir¬ 
ginia.  Sources  for  C  tools  were  found  in  the  Archie  bulletin  board  (Ref.  4).  The  util¬ 
ity  programs  are  from  the  X11R4  libraries.  Considerable  time  and  effort  was  spent 
compiling  and  executing  tools  from  the  Ada  repositories.  Some  tools  worked,  some 
did  not  work  well,  and  some  did  not  work  at  all.  “House  cleaning”  at  repositories 
needs  to  be  done  with  the  help  of  the  user  community. 

Lessons  learned  searching  for  "good"  public  domain  tools  will  be  briefly  dis¬ 
cussed.  The  ASR  and  AdaNet  each  contained  six  Ada  pretty  printers.  Only  Pretty 
Printer  4  and  pretty  printer  6  were  written  in  valid  Ada.  Pretty  Printer  6  was  selected 
because  task  members  could  not  get  Pretty  Printer  4  to  execute  properly.  Note  that 
Pretty  Printer  6  contains  some  minor  bugs. 

Two  Ada  body  slubbers  were  found  in  the  ASR  and  AdaNet.  Neither  execute  when 
a  validated  Ada  compiler  is  used.  Body  Stubber  2  was  modified  by  task  members  so 
that  it  does  run  on  validated  Ada  compilers.  This  modified  body  stubber  is  being  « 

incorporated  into  the  December  1992  release  of  the  Ada  Language  System/Navy 
(ALS/N). 

Several  Ada  line  counters  were  examined  in  the  two  repositories.  The  line  counter 
File_Checker  was  selected.  Several  bugs  were  found  in  it  and  fixed. 
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The  C  line  counter  selected,  kdsi,  was  located  in  the  Archie  bulletin  board  (Ref.  4). 
One  minor  bug  (for  an  uninitialized  variable)  was  fixed  before  it  was  integrated  into 
the  ETI.  Archie  can  be  accessed  by  rlogin-ing  or  telnet-ing  to  archie .  ans  .  net 
(147.225.1.2)  or  archie.sura.net  (128.167.254.179)  with  username  "archie" 
and  no  password. 

The  C  pretty  printer  currently  used  is  from  SunOS  4.1.1.  For  portability  reasons, 
the  next  version  of  the  ETI  will  probably  use  the  C  pretty  printer,  cpr,  which  is  listed 
in  the  Archie  bulletin  board  (Ref.  4). 

5.7  HUMAN  FACTORS  INVOLVEMENT 

A  human  factors  expert,  Dr.  K.  Fernandes  of  NRaD,  periodically  evaluated  the  ETI. 
She  provided  invaluable  comments  regarding  simplifying  the  user  interface.  Her  user 
interface  standard  was  followed  (Ref.  1).  Her  comments  related  to  consistency,  read¬ 
ability,  and  other  aspects  covered  in  the  interface  standard. 
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6.0  RECOMMENDATIONS 


6.1  RECOMMENDATIONS  FOR  FUTURE  ETI  RESEARCH 

Below  is  a  list  of  recommendations  for  future  ETI  research  and  development: 

1.  Make  the  following  improvements  to  the  ETI: 

•  Add  tool  search  capability  to  find  category  where  tool  is 
located. 

•  Add  comprehensive  error  messages  for  setup  table. 

•  Add  context-sensitive  help  capability. 

2.  Port  the  ETI  to  additional  Unix-based  computers. 

3.  Write  Motif  front-ends  to  the  Ada  tools.  This  front-end  is  especially  needed  for 
the  pretty  printer. 

4.  Include  additional  Ada  tools.  Those  being  considered  for  inclusion  are  Halstead 
metrics,  McCabe  metrics,  path  analyzer,  performance  analyzer,  and  statement  profiler 
from  AdaNet.  Others  that  have  wide  application  are  also  candidates. 

5.  Include  C++  tools  and  write  Motif  front-ends  for  these  tools.  These  include  a 
pretty  printer,  a  line  counter,  and  others  that  are  in  the  public  domain  and  have  wide 
application. 

6.  Include  additional  C  tools  and  write  Motif  front-ends  for  them.  These  tools  in¬ 
clude  a  cross  referencer,  prototypes  declaration  generator,  and  others. 

7.  Write  Motif  front-ends  for  commercial  CASE  tools  to  facilitate  their  use.  These 
front-ends  facilitate  the  use  of  startup  scripts  to  define  tool  parameters.  Tools  may 
include  CADRE  Teamwork  and  Interactive  Development  Environments’  (IDE)  Software 
Thru  Pictures. 

6.2  RECOMMENDATIONS  FOR  SOFTWARE  DEVELOPERS 

The  following  are  general  recommendations  based  on  what  we  observed  while 
developing  the  ETI: 

1.  Developers  of  DoD  software  and  CASE  tool  developers  should  have  human  fac¬ 
tors  specialists  evaluate  early  prototypes  of  their  user  interfaces.  This  will  help  to 
eliminate  awkwardness  and  inconsistencies,  and  to  simplify  the  use  of  the  tools. 

2.  Software  developers  should  use  standards  to  help  them  produce  user  interfaces 
that  are  consistent  in  appearance  and  in  operation. 
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Appendix  A 

USING  THE  TOOLS 

This  appendix  briefly  describes  the  tools  that  are  included  with  the  ETI  and  shows 
in  detail  how  to  use  them.  Specific  examples  are  provided.  The  test  files  that  are 
described  in  the  examples  below  are  included  with  version  1.1  of  the  ETI.  Users  may 
run  the  examples  exactly  as  given  here. 

A.1  C  TOOLSET 

Line  Counter 

Function:  The  line  counter  is  the  "kdsi"  program  written  by  B.  Renaud.  It  was 
obtained  from  Ohio  State  University.  A  Motif  front-end  was  added.  Line  counter 
reads  in  text  files  and  displays  the  number  of  lines  of  code,  blank  lines,  comment 
lines,  and  number  of  comments  to  the  user’s  monitor. 

Example:  The  user  provides  input  through  the  menu  given  in  figure  A-l.  In  this 
example,  the  user  wanted  the  counts  for  all  C  files  in  the  directory  "$SWEEP__HOME/ 
testfiles" .  This  was  indicated  in  the  "Input"  box.  The  user  executed  the  tool 
by  clicking  on  the  "Execute"  box.  The  bottom  panel  displays  the  lines  of  code, 
blank  lines,  comment  lines,  and  number  of  comments  for  all  C  files  in  the  designated 
directory. 

To  output  counts  to  both  the  user’s  monitor  and  a  file,  the  user  must  enter  a  file 
name  in  the  "Output"  box. 

The  “Display  available  files"  box  allows  a  user  to  list  files. 

Additional  information  on  the  line  counter  may  be  found  by  examining  the  source 
code  and  "readme"  files  that  are  in  the  directory  "$SWEEP_HOME/tools/c/ 
kdsi"  on  the  user’s  computer. 

Pretty  Printer 

Function:  This  pretty  printer  is  the  C  beautifier  (cb)  program  in  Ref.  5.  A  Motif 
front-end  was  added.  The  pretty  printer  reads  in  a  C  source  code  file  and  produces  a 
source  file  with  indentation.  The  user  can  join  split  lines  and  can  split  lines  that  are 
longer  than  a  user-specified  length. 

Example:  The  user  provides  input  through  the  menu  given  in  figure  A-2.  In  this 
example  the  user  wanted  the  file  "$SWEEP_HOME/ test  files /main,  c"  to  be 


A-l 


reformatted  into  standard  C  style  and  to  be  output  to  the  file  "<path>/sweepl .  1/ 
testf  iles/reformatted_main.c".  The  user  must  provide  the  remainder  of 
the  path  name,  which  is  indicated  by  <path>.  To  run  the  pretty  printer,  the  user 
entered  these  file  names  in  the  appropriate  boxes  and  clicked  on  the  option  for  stan¬ 
dard  C  style.  The  output  was  both  displayed  in  the  bottom  panel  of  figure  8  and  writ¬ 
ten  to  the  designated  file. 

To  direct  the  output  to  the  screen  only,  the  user  does  not  provide  an  output  file 
name.  Options  are  also  available  to  join  split  lines  and  to  split  lines.  These  options 
may  be  invoked  simultaneously. 


C  Line  Counter 


Input:  $S  WEEP_HOM  E/testf  iles/“  .c 


Display  available  files 


Output: 


Figure  A-l.  Menu  for  C  line  counter. 
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Pretty  Printer 


Output  options: 

□  Standard  C  style  (-s) 

□  Join  split  lines  (-j) 

Split  lines  longer  than  (-1) 


Execute 


Clear 


#include  <X1 1/lntrinsic.h> 

#include  <Xm/Xm.h> 

•include  <XnVPushB.h> 

•include  <Xm/Label.h> 

•include  <Xm/BulletinB.h> 

•include  <XrrVSeparatof.h> 

extern  void  button  CBO; 

main(int  arge.char'argvQ) 

{ 

widget  toplevel,button,bb; 
Arg  a1[10], 
int  ac; 


Figure  A-2.  Menu  for  C  pretty  printer. 


Within  the  ETI,  the  user  may  examine  the  contents  of  the  output  file  by  going  to 
UTILITY  and  Command  Shell  and  then  typing 

more  <path> / sweep 1 . 1/testf i les/reformatted_main . c 

Additional  information  on  the  pretty  printer  is  found  in  Ref.  5,  page  53. 
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A.2  ADA  TOOLSET 


Body  Stubber 

Function:  Body  stubber  creates  an  Ada  package  body  with  stubs  for  subprograms  and 
tasks  from  an  Ada  package  specification  that  contains  the  specifications  for  subpro¬ 
grams  and  tasks. 


Input: 

Ada_Package_Spec  — 

Ada  package  specification 

i 

with  subprogram  and  task 
specifications 

%■ 

Output: 

Ada_Package_Body  — 

Ada  package  body  with 
stubs  for  subprograms  and 
tasks 

Example:  Below  is  what  a  typical  session  looks  like  immediately  after  the  body  stub¬ 
ber  is  invoked: 

Enter  name  of  file: 

$SWEEP_HOME/testf iles/stubber_input 

Enter  output  file  name(Default:$SWEEP_HOME/testf  iles/stubber_in- 
put_body) : 

RETURN  —  When  user  presses  return  default  file  is  created. 


Compilation  Order  Maker 

The  Compilation  Order  Maker,  being  developed  by  NRaD,  determines  the  proper 
compilation  order  of  a  collection  of  files. 

Line  Counter 

Function:  Counts  Ada  source  code  statements,  comments,  and  lines  (card-image  state¬ 
ments). 

Input:  Ada_Source_File  —  File  containing  Ada  source  code 

or 

@Ada_Source_Files  —  File  containing  names  of  source  code 
Output:  Lines_of_Code_File  —  File  containing  line  counts. 

Example:  Below  is  an  example  of  a  session  when  the  line  counter  is  invoked: 

FILE  CHECKER,  Version  1.4 


A-4 


Name  of  Output  File  (RETURN  to  Abort)? 

$SWEEP_HOME/test f i les/pretty_print_output 

—  User  provides  output  file  name. 

File  Name  >  $SWEEP_HOME/testfiles/pretty_print_input 

—  This  test  file  is  provided. 

File  Name  >  RETURN  —  Press  RETURN  to  terminate  program. 

Pager 

Function:  Pager  combines  many  files  into  a  concatenated  file  and  breaks  a  concate¬ 
nated  file  into  multiple  files.  The  information  below  is  for  breaking  a  concatenated 
file  into  multiple  files. 

Input:  Large_Ada_Source_File  —  This  is  concatenated  file  in  pager  format 

Output:  Multiple_Files  —  Individual  files 

Example: 

The  example  given  below  breaks  a  concatenated  file  into  individual  files.  The  user 
can  see  other  pager  options  that  are  available  by  entering  "h"  for  help: 

PAGER2,  Modified  Pager2,  Ada  Version  1.1 
type  '  h '  for  Help 

PAGER2>  u  $SWEEP_HOME/testf iles/pager_input 

Extracting  compilation.txt  —  5  lines 

Extracting  cas3.a  —  301  Lines 

Extracting  list. a  —  304  Lines 

Extracting  fcheck.a  —  327  Lines 

PAGER2>  x  —  Exits  user  from  pager. 

Pretty  Printer 

Function:  Reads  in  Ada  source  code  files  and  creates  an  output  file  with  spacing, 
indentation,  and  capitalization  that  conforms  to  the  proposed  Ada  Style  Guide  Hand¬ 
book  (Ref.  6). 

Input:  Ada_Source_File  —  File  containing  Ada  source  code, 

or 

@Ada_Source_Files  —  File  containing  Ada  source  code  file  names. 

Output:  Reformatted_Ada_Source  —  Reformatted  Ada  source  code 
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Example: 

Below  is  an  example  of  a  session  after  the  line  counter  is  invoked. 

Ada  File?  >  $SWEEP_HOME/testfiles/pretty_print_input 

$SWEEP_HOME/testfiles/pretty_print_inppp  created 

—  File  of  reformatted  Ada  source  code. 

$SWEEP_HOME/testfiles/pretty_print_inpsr  created 
—  File  containing  statistical 
—  information  on  source  code. 

A.3  UTILITY 

A.3.1  Calculator,  Clip  Board,  Command  Shell,  and  E-Mail 

The  calculator,  clip  board,  command  shell,  and  E-Mail  tools  are  provided  by  the  X 
Window  System.  User  information  on  these  tools  can  be  found  on-line  by  using  "man 
pages".  For  example,  type  "man  xcalc" ,  "man  xclipboard",  "man 
xterm" ,  "man  xmh"  at  the  Unix  prompt  to  display  manual  pages  for  the  calcula¬ 
tor,  clip  board,  command  shell,  and  e-mail,  respectively. 

A.3.2  Editors 

A.3.2.1  NED.  The  Navy  Command  and  Control  System  Ashore  Editor  (NED)  is  a  text 
display  and  editing  system  that  was  designed  for  viewing  portions  of  source  code  and 
documentation  stored  in  the  CRSS  library.  NED  may  also  run  as  a  stand-alone  appli¬ 
cation  for  editing  text  files.  NED  was  developed  by  K.  Allen,  Intermetrics  for  the  OSS 
project.  NED  user  instructions  are  contained  in  Ref.  2. 

A.3.2.2  Emacs.  Emacs  is  the  GNU  Emacs  editor  from  the  Free  Software  Foundation. 
The  editor  includes  facilities  to  send  and  receive  mail,  run  subprocesses,  and  do  com¬ 
pilations.  It  was  written  by  R.  Stallman. 

A.3.2.3  Xedit.  Xedit  is  a  customizable  text  editor  for  the  X  Window  System  devel¬ 
oped  by  MIT.  It  was  written  by  C.  Peterson,  MIT  X  Consortium. 

A.3.3  File  Manager 

File  Manager  is  a  Motif  application  used  to  navigate  through  file  hierarchies.  This 
tool  provides  facilities  to  search,  move,  copy,  compress,  and  view  files,  and  to  obtain 
file  information.  It  was  developed  by  K.  Allen  of  Intermetrics  for  the  OSS  project. 
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Appendix  B 

BACKGROUND  INFORMATION  ON  THE  ADA  TOOLS 


Ada  Primitive  Compilation  Order  Tool  (APRICOT) 

APRICOT  is  a  tool  for  determining  the  compilation  order  of  a  collection  of  Ada 
f  files.  It  is  being  developed  by  R.  Ollerton  of  NRaD.  It  currently  runs  on  VAX/VMS 

and  will  be  ported  to  Suns  and  additional  platforms.  It  also  performs  the  functions  of 
_  pager  and  creates  command  compilation  files  from  concatenated  pager  files. 

Body  Stubber 

The  body  stubber  is  Body  Stubber  2  from  the  ASR,  White  Sands,  New  Mexico.  It 
was  written  by  J.  Orost  of  Concurrent  Computer  Corporation  and  was  upgraded  by  N. 
Tran  of  NRaD  to  run  on  VAX/VMS  (DEC  Ada),  Sun  (Verdix),  and  other  validated 
Ada  compilers.  This  tool  is  especially  useful  for  large  projects,  where  interfaces  must 
be  defined  very  early.  The  body  stubber  reads  in  an  Ada  package  specification  that 
contains  the  specification  for  subprograms  and  tasks.  It  automatically  creates  a  compil¬ 
able  package  body  containing  stubs  for  the  subprograms  and  tasks.  It  was  resubmitted 
to  the  AdaNet  Repository  in  December  1991  by  NRaD. 

Line  Counter 

The  Ada  line  counter  is  File  Checker  from  the  ASR.  It  was  written  by  R.  Conn  of 
Texas  Instruments  (Tl)  and  the  Management  Assistance  Corporation  of  America 
(MACA).  Fixes  have  been  made  by  R.  Mumm  of  NRaD  and  P.  Babick  of  Science 
Applications  International  Corporation  (SAIC).  The  line  counter  is  written  in  Ada  and 
runs  on  VAX/VMS  (DEC  Ada),  Sun  (Verdix),  and  other  validated  Ada  compilers.  The 
tool  counts  Ada  source  lines  of  code  several  ways.  It  was  used  on  the  Ada  Bit-Ori¬ 
ented  Message  Handler  (ABOM)  project  by  NRaD  and  SAIC  to  report  programmer 
productivity  statistics.  It  was  resubmitted  to  the  AdaNet  in  December  1991. 

Pager 

» 

The  pager  is  Pager2  from  the  ASR.  It  was  developed  by  Richard  Conn,  Texas 
%  Instruments  and  MACA.  It  was  written  in  Ada  and  runs  on  VAX/VMS  (DEC  Ada), 

Verdix  (Sun),  IntegrAda,  and  other  validated  Ada  compilers.  The  tool  concatenates 
Ada  source  files,  breaks  concatenated  files  into  individual  files,  and  makes  listings. 
Pager  requires  that  source  files  be  in  the  pager  format,  a  prefixed  banner  of  comment 
statements.  Pager  is  a  tool  that  is  used  for  storing  and  transporting  related  files.  It  is 
used  by  ASR  and  AdaNet  users  to  separate  concatenated  files. 
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Pretty  Printer 


This  pretty  printer  is  Pretty  Printer  6  from  the  ASR.  It  was  written  by  A.  Shell  of 
AdaCraft,  Inc.,  for  the  NASA/Goddard  Space  Flight  Center.  It  was  written  in  Ada  and 
runs  on  VAX/VMS  (DEC  Ada),  SUN  (Verdix),  PC  (Alsys),  and  other  compilers/com¬ 
puters.  Pretty  Printer  6  implements  many  of  the  directives  in  Ref.  6.  The  modifica¬ 
tions  required  to  change  the  number  of  columns  of  indentation,  the  case  of  variable 
names,  and  other  pretty  printer  parameters  are  isolated  in  one  Ada  package  specifica¬ 
tion.  This  pretty  printer  was  used  by  NRaD  for  the  Ada  discrete-event  simulation 
research  conducted  by  the  Shared  Adaptive  Internetworking  (SAINT)  project. 
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